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(54) Dynamic property sheet system 

(57) Methods and apparatus for the concunrent dis- 
play of two or more property pages of a Graphical User 
Interface (GUI) are disclosed. A user can select a prop- 
erty page displayed by a first property sheet system and 
create a second property sheet system that displays the 
selected property page at second, user selected display 
position. Alternatively, the user can place, or dock, the 
selected property page into an existing property sheet 
system for inclusion therein and display thereby. The 
first property sheet system displays, at a first display 



position, any of the property pages remaining therein. 
Typically, the selected property page is removed from 
the first property sheet system and the first property 
sheet system is destroyed if it contains no other prop- 
erty pages. The invention allows a user of a GUI to con- 
currently display and interact with nuiltiple property 
pages of multiple property sheet systems for optimizing 
the exchange of information with the GUI. 
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Description 

A portion of the disclosure of this patent document contains material which is subject to copyright protection. The 
owner has no objection to the facsimile reproduction by anyone of the patent document or the patent disclosure, as it 
5 appears in the Patent and Trademark Office patent file or records, but otherwise r serves all copyright rights whatso- 
ever. 

Field of the Invention 

10 The present invention relates to graphical user interfaces, and particularly to property sheet systems having prop- 
erty pages viewable on a graphical user interface. 

Background 

15 A graphical user interface (GUI) is an indispensable feature of most modem computer systems. A GUI allows a user 
to interact intuitively with an application program running on the computer by allowing the user to manipulate pictorial 
representations of objects. Many of the display components of a typical GUI, such as title bars, menu baxs, icons, mul- 
tiple windows, scroll bars, pop up menus and dialog boxes, are now standard features. A modem GUI represents a 
major improvement over the text-based entry systems of just a few years ago. 
20 Typical dialog boxes of a GUI system allow a user to exchange information with an application program. Some dia- 
log boxes simply require a user to confirm an operation before it is executed by the computer; other dialog boxes may 
ask for user selected input, such as choice of a disk drive, directory, file name, file type, network path, etc. Dialog boxes 
typically comprise components such as text boxes, list boxes, option buttons, and command buttons. 

If a large amount of related information is to be exchanged between a user and the computer a GUI may include a 
25 special type of dialog box known as a property sheet system. A property sheet system, for example, can have a display 
that includes several tabs which represent different dialog boxes, known as a property pages. The user can select a tab 
to display the particular property page associated with that tab. Once selected, the user can enter information, confirm 
an operation, or make other appropriate option choices. 

Available property sheet systems can be frustrating to use. For example, to configure optimally an application pro- 
30 gram, a user often exchanges information with the program by using several modeless property pages. Often the con- 
figuration options that result in the desired performance of the application are not immediately obvious and are arrived 
at by some trial and error. Unfortunately, because the property sheet system displays only one property page at a time 
on a monitor, a user usually selects appropriate tabs to switch between multiple property pages. e.g. property pages 
are relegated to tiie background Furthermore, the user is typically required to remember the particular settings on tiie 
35 nondisplayed property pages. This procedure of continually switching between property pages to configure a system is 
overly laborious and time consuming. 

Accordingly, an object of the invention is to provide a property sheet system tiiat allows a user to easily and effi- 
cientiy exchange information with an application program. 

A further object of the invention is to provide a property sheet system that reduces the need of a user to choose 
40 continually between displayed and nondisplayed property pages when the exchange of information requires the use of 
more than one property page. 

Other general and specific objects of the present invention will be apparent and evident from the accompanying 
drawings and the following desaiption. 

45 Summary of the Invention 

The present invention relates to. broadly, the creation of a second property sheet system from a first property sheet 
system. The first property sheet system includes one or more property pages, which are displayable on a display mon- 
itor at a first display position. The first property sheet system is often part of an existing application program. For exam- 

50 pie. a word processor program on which this application is being typed has a property sheet system for setting up 
printers. This property sheet system includes "tabbed" property pages entitied "setup", "paper", "destination", "print 
quality", and "fonts". According to the invention, a property page is selected is response to an input signal from a user- 
operated pointing and selecting device, such as a mouse. In response to a second signal generated by the user, typi- 
cally via the mouse, tiie selected property page is Included in. and displayed by. a second property sheet system. The 

55 user may tiius display and interact with two property pages simultaneously: the selected property page, which is dis- 
played by tiie second property sheet system, and any ne f the property pages remaining in the first property sheet 
system, which is displayed by the first property sheet system. 

One t chniqu by which a user may select a property sheet is by ^tearing," tiiat is, selecting a tab representing a 
property page of tiie first property sheet system. The property page lorn" or selected from the first property sheet sys- 
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tern is displayed at a second location, determined by the user, on the display screen. Typically, a user mploys "drag 
and drop" operation to select a property page, create a second property sheet system, and to display the torn property 
page at a user-selected display location. 

As noted, aeating more than one property sheet system allows a user to view and exchange data with an applica- 

5 tion program using two or more propety pages that are viewed simultaneously. The user need not continually switch 
between displayed and non displayed property pages, nor need he or she commit to memory the contents of one or 
more property pages. Note that as used herein, the term property page or sheet is intended to include a modal or mod- 
eless secondary window that displays user-accessible properties of an object. A property page is said to be included in 
a property sheet system and can be displayed in a variety of formats to best allow a user to exchange information with 

10 a computer or with an application program running on a computer. 

Additionally, property pages can be exchanged between property sheet systems, whether these systems are ae- 
ated according to the invention or exist as part of a separate application program, such as a word processor program. 
A property page "torn" from a property sheet system is typically displayed as a geometric object or other symbol during 
the "drag" portion of the "drag and drop" operation. A user can place the selected, or "torn." property page in an existing 

15 property sheet system for inclusion therein and display thereby, rather than in a new property sheet system created to 
include the selected page. Typically, the user places the symbol representing the "torn" page in dose proximity to a 
property page displayed by the property sheet system into which it is desired to drop the "torn" page. A docking input 
signal, such as release of a mouse button, causes the selected property page to "drop", or "dock" into the chosen prop- 
erty sheet system. Once docked in the chosen system, the property page may be used by the user just as when it was 

20 in the previous property sheet system. 

According to one aspect, the invention includes a processor; a memory element; a display monitor; a user input 
device; a selection element for selecting a property page of a first property sheet system responsive to a signal gener- 
ated by a user input device, such as. for example, mouse, trackball, or keyboard; and a second program element for 
creating a second property sheet system for including the selected property page and for displaying the selected prop- 

25 erty page at a second display position on the display monitor. 

According to another aspect, the invention includes a removal element for removing from the first property sheet 
system the property page selected by the selection element such that the selected property page is not displayable by 
the first property sheet system. 

In yet another aspect, the invention includes a destruction element for destroying a property sheet system when 

30 system does not include any property pages, such as when the last page in the system has been removed by the 
removal element. 

According to another aspect of the invention the invention further includes a docking element for. in response to a 
signal generated by a typical user input device, placing a property page selected by the selection means into a selected 
property sheet system for inclusion therein and display thereby. 

35 In yet another aspect, the invention incorporates a positioning program element, responsive to input signal gener- 
ated by the user input device, for selecting the second display position at which the second property sheet system dis- 
plays property sheets included therein. 

In a different variation, the positioning element varies the display position of a symbol in response to a user input. 
The second program element, responsive to the user input, displays the selected property page at the second position. 

40 The positioning element also allows for plaong the syn^l in substantial registration with a displayed property page of 
a property sheet system such that the docking element, responsive to a user input signal, such as release of a mouse 
button, places the selected property page into the property sheet system with which the symbol was in substantial reg- 
istration. The symbol can be the dotted outline of a box. and the box can be the approximate size of a displayed property 
page. 

45 To aid the user in docking a selected property page into an existing property sheet system, the inventon can 
include an element for displaying on the display monitor an icon having a second display state for indicating to a user 
when the symbol or geometric object is in substantial registration with a property page of a property sheet system. For 
example, the icon second display state can comprise a display of a two puzzle pieces that are mated, and the icon can 
have a first display state comprising two puzzle pieces that are not mated, for indicating a when a symbol or geometric 

50 figure is not properly registered, i.e., the selected property page will not be docked by the docking means into an exist- 
ing property sheet system. 

According to another feature of the invention, in addition to a positioning element responsive to user input for var- 
ying a position of symbol displayed on the display monitor, a a proximity program element is included. The proximity ele- 
ment determines a parameter responsive to the distance on the display monitor between the symbol and the position 
55 on the display monitor of a displayed property page of a property sheet system. When the parameter is less than a first 
amount, the docking means, responsive t a first user input signal generated by the user input devic . places the prop- 
erty page selected by the selection element into the property sheet system for inclusion therein and display thereby. 
When the parameter varies from the selected value by a second selected amount the second program means, respon- 
sive to a second input signal, places the property page in a newly aeated property sheet system and displays the 
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selected property page at a position on the display monitor substantially determined by the display position of the sym- 
bol. For example, the displayed property page can be centered about the position of the symbol. The first and second 
Input signals can be responsive to the release of a mouse button as part of the "drag and drop" procedure. 

Of course, the invention pertains not only to a computer programmed in the manner desaibed above to perform 

5 the transformation and operations described above, but to a machine readable data storage medium including the 
at)ove-described elements. The invention is also understood to comprise methods for performing the above operations. 

It will thus be seen that certain changes may be made in the above constructions without departing from the scope 
of the invention. It is intended that all matter contained in the above and following description or shown in the accompa- 
nying drawings be interpreted as illustrative and not in a limiting sense. 

10 It is also to be understood that the following claims are to cover all generic and specific features of the invention 
described herein, and all statements of the scope of the Invention which, as a matter of language, might be said to fall 
therebetween. 

Brief Pescription of the Prawlngs 

15 

The foregoing and other objects, features and aspects of the invention will be apparent from the following descrip- 
tion and apparent from the accompanying drawings, in which like reference characters refer to the same parts through- 
out the different views. The drawings Illustrate principles of the invention and. although not to scale, shown relative 
dimensions. 

20 FIGURE 1 illustrates a typical computer system according to the invention. 

FIGURE 2 illustrates a typical property page of a property sheet system for configuring, for example, the keyt>oard 
display of an application program. A user accesses each property page of the property sheet system by selecting the 
appropriate tab displayed at the top of the property page window display. 

FIGURE 3 illustrates an intermediate display presented as part of the "drag and drop" procedure for aeating a new 
25 property sheet system including a property page lorn" from the first property sheet system of FIGURE 2. 

FIGURE 4 illustrates a second property sheet system including the property page "torn" from the first property 
sheet system illustrated in FIGURE 2 and which is displayed simultaneously therewith. 

FIGURES 5A and 5B depict the selected display states of a dynamic Icon for aiding a user in "docking" a property 
page removed from one of the property systems for placement within another sheet system. 
30 FIGURE 6 is a flow chart diagram illustrating the steps involved in removing a property page from a property sheet 
system and placing it in a second property sheet system, as depicted in FIGURES 2-4. 

FIGURE 7 is a schematic illustration block diagram of the software components utilized in accordance with the 
teachings of the present invention; 

FIGURE 8 illustrates the object classes, and their relationships, in accordance with the teachings of the present 
35 invention. 

FIGURES 9A-9C illustrate parent-child relationships of particular object classes depicted In FIGURE 8 and used In 
the software coding according to the teachings of the invention. 

FIGURE 10 Is a hierarchical schematic Illustrating the derivation of key property pages from a property page base 
class according to the teachings of the present invention. 

40 

The removing or tearing of property pages from a property sheet system. In accordance with the teachings of the 
present invention, extends the user interface of standard Windows/Windows 95/Windows NT property pages to enable 
45 a user to change values on separate property pages simultaneously without changing visual context. The user can grab 
the active property page and pull/tear it away from the property sheet system and place it in an existing or newly created 
property sheet system. However, one of ordinary skill in the art in accordance with the teachings herein, understands 
the invention to be applicable to GUrs in otiier operating environments, such as, for example, X-Windows. Motif, and 
IBM OS/2, 

so The practice of the invention includes a computer, such as the computer 2 illustrated in FIGURE 1 . The computer 
2 typically includes input-output hardware 3. a central processor 4, random access memory 5. disk storage 6. a key- 
board 7, pointing device, such as a mouse 8 and a display monitor 10. The Input/output hardware 4 connects the com- 
puter 2 to, for example, a network. 

FIGURE 2 illustrates a typical computer display screen display 12 of a property page 1 4 of a property sheet system. 

55 The property page 14 in FIGURE 2 is used for configuring the keyboard display 16 of an application program that mon- 
itors and controls industrial processes. One such industrial process control system is the I/A SERIES® System availa- 
ble from The Foxboro Company, of Foxboro. Massachusetts. USA. However, an industrial process monitoring system 
is merely one example of the type of environment in which prop rty pages are typically very useful: the present inven- 
tion is useful in many computer application programs, such as word processors, spreadsheets, communications pack- 
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ages, web browsers, etc. However, in the particular embodiment illustrated here, the property pages are used to 
configure a keypad annunciator of an industrial process control system, such as the keypad annunciator 16 in FIGURE 
2. Many of the keys of a keypad annunciator 16 are configurable, via property pages, such that a given individual key is 
associated with a particular alarm state of th industrial process control system; occurrence of that alarm state causes 

5 the key to change appearance. The key is also configurable such that selecting the key with the mouse can initiate 
selected corrective action or display a selected process graphic. 

To "tear" a page from a property sheet system, the user positions a cursor over the body (i.e., generally anywhere 
other than an edit field or the tab representing the property page 14) of property page 14 and provides an input signal, 
typically by depressing a button on the mouse. During this tearing, or selection, process the user is presented with an 

10 outline of the property page while the mouse is pressed, and the outline can be positioned by "dragging" it anywhere 
on the display screen. FIGURE 3 illustrates the outline 20 of property page 14 that is in the process of being torn from 
its property sheet system. Once the desired position is found, releasing the mouse button signals the application to cre- 
ate a new property sheet dialog system and populate it with the torn-away property page. Typically, the original property 
page 14 is removed from its original container, e.g.. the first property sheet system, and is only available in the second 

75 property sheet system. The user can view and change values using different property pages in one visual context, that 
is. to view them simultaneously positioned above the desktop 13. FIGURE 4 illustrates the simultaneous display of two 
property pages, the torn page 1 4. displayed in the display window 24 of the newly aeated property sheet system, and 
property page 22. now displayed in the original property sheet system display window 1 5, and corresponding to the tab 
25 labeled ''displays." The tab 1 8 labeled "actions" in FIGURE 2 is removed from property sheet display window 1 5 and 

20 now appears in display window 24 in the newly aeated property sheet system, as illustrated in FIGURE 4. The property 
page 14 and the property page 22 are now displayed concurrently, and the user can exchange data with either of them. 
Typically, as the user interacts with one of the displayed property pages, the other is updated, as necessary, to reflect 
the data exchange with the other. For example, if the display window 24 of the newly created property sheet system is 
active, that is, the user is exchanging data with the property page 14, the property page 22, displayed in the non-active 

25 window 15 of the original property sheet system, is updated, as necessary, to reflect the any data input by the user to 
the property page 14 displayed in window 24. 

In addition to being able to create a new property sheet system for displaying the selected property page, the user 
can place the selected property page into an existing property sheet system. The user attaches, or docks, a "torn" prop- 
erty page into an existing property sheet system by dragging the outline 20 over the top of a property page displayed 

30 by that system. Releasing the mouse button when the outline is so positioned docks the property page into the property 
sheet system. As discussed immediately atK)ve. a displayed property page in a non active window is updated, as nec- 
essary, to reflect any input by a user to a displayed property page in an active window. Using the docking procedure, 
the property page 14 in FIGURE 4 can be selected and placed back into in the original property sheet system for re- 
display in display window 15. 

35 A visual cue, such as a dynamic icon 28 in FIGURES 5A and 5B, is provided to assist in the tear-away/docking 
operation. During the dragging process, the user is provided with a symbol such as dynamic icon 28 that shows two 
puzzle pieces. When the drag box is over a dock-site. i.e.. over an existing property sheet system that can accept the 
property page being dragged, the puzzle pieces join and appear as a second display state 32. thus signifying to the 
user that the dragged page can be docked e.g.. accepted into the that system. FIGURE 5A illustrates the dynamic Icon 
40 in the first display state 30 wherein the puzzle pieces are separated, indicating that the drag box or geometric shape 20 
is not properly positioned for a property page to be docked. 

The invention uses the logic depicted in the operational flow chart illustrated in Figure 6. Starting at decision box 
34. pressing a mouse key when the cursor is within a property page "tears" the property page and leads along the "yes" 
branch of box 34 to box 36. As the mouse is dragged, that is, moved with the nwuse button pressed, an outline of the 
45 property page is drawn on the saeen. This process will continue until the user releases the mouse button. Releasing 
the mouse button leads from along the "yes" branch of box 36 to decision box 38. which determines whether the torn 
property page can be docked, that is, whether the drag box 20 is positioned over a property page of an existing property 
sheet system. If docking is possible, the torn page is docked into the larget" system, as In box 42; if the page cannot 
be docked, a new property sheet system is created for inclusion of the torn property page, as indicated by box 40. 
50 Finally, in box 44, the torn page is removed from the original property sheet system, and if no other pages remain in the 
original, or source, property sheet system, the system is deleted, or destroyed. In the remainder of the specification, the 
object classes and coding to perform the above-described operations are described. 

The present invention uses techniques of object-oriented programming. In object-oriented programming, routines 
are separate entities that include both data and functions, or methods, for processing the data. Object-oriented pre- 
ss gramming differs from traditional structured programming, which relied heavily on subroutines, and in which data and 
the routines that handled the data were usually strictly segregated. Structural programming Is organized in terms of 
computer details, such as f iles, record, and sorting algorithms; object oriented programming is organized in terms of the 
physical entities, the 'objects." that exist in the environment in which th problem is to be s ived. The data and methods 
stored in a object represent respectively, the attributes of the physical object and the actions a object is capable of car- 
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rying out. Objects are related to classes; an object is said to be an instance of a dass. A class is not an object, but a 
template that instructs a compiler how to construct an actual object. 

Those of ordinary skill in the art of modern programming are familiar with object-oriented concepts such as encap- 
sulation, Inheritance and polymorphism. Encapsulation refers to combining data and functions, or methods, that proc- 

5 ess the data into a single object, wherein the internal details of the methods and data may be largely hidden. 
Inheritance refers to a derived class inheriting the features and capabilities of the base, or parent, class. The derived 
class can then be modified to suit a particular need. Polymorphism allows objects whose properties differ to be able to 
function together. That Is, the interfaces through which objects exchange messages are standardized and not depend- 
ent on the exact internal working of an object. Because of encapsulation, polymorphism and inheritance, object ori- 

10 ented-programming Is a modular approach that reduces the amount of coding a designer of a new system or function 
needs to perform. Objects can be joined in a coherent procedure in which objects can be added, modified or deleted 
without a designer having to rewrite a whole application. A considerable anrK)unt of code written by others is reusable, 
and is often reused. For example, the Microsoft Foundation Class (MFC) Library is a set of more than 100 classes 
designed to help C++ programmers write Windows-based programs. The present invention built upon classes from the 

15 MFC version 4.1 library. 

Accordingly, described herein are only those class definitions, and code segments, necessary for one of ordinary 
skill in the relevant programming arts, possessed of all the teachings herein, to make and use the invention. Classes, 
objects and codes well known to, or easily created by. those of ordinary skill in the art. or available in published libraries, 
such as MFC library, are not described, or if described, are only briefly discussed. 
20 The present invention provides for a sophisticated property sheet system that supports modeless operation and 
tear-away property pages. The system uses the standard system software components illustrated in FIGURE 7. The 
components include the application frame window 46 and the property sheet system 48. In general, property sheet sys- 
tems are implemented using three components: a property frame 48A, a property sheet 48B, and one or many property 
pages 48C. These three components 48A-48C are related. The property pages 48C are the children of the property 
25 sheet 48B; the property sheet 48B is the child of the property frame 48A; and the property system 48 is owned by the 
application's main frame window 46. Because the property frame 48A is typically a top-level window, it generally cannot 
be a child of another window, but it can be owned. 

The present invention extends the standard property sheet system, such as that in FIGURE 7, by extending the 
standard classes to allow the tearing of property pages, the creation of new property sheet systems, and the docking 
30 of torn property pages into existing property sheet systems. The classes are illustrated in FIGURE 8. 

The application frame window dass 50, labeled CACRFrameWnd In FIGURE 8, provides management support for 
the property sheet system 55. The application frame window class 50 provides property page dock support, property 
page availabil'ity handling, and property sheet system creation. The application flame window 50 constructs the prop- 
erty sheet system 55 with a creation mask that indicates which property pages 56 to create. Additionally, the application 
35 frame window 50 provides the notification interface used by the property sheet system 55 when property or selection 
information has changed in a property page 36. 

The property sheet system 55 is comprised of three distinct parts. The first and least significant of these compo- 
nents is the property sheet frame dass 52. The property sheet frame 52 is a mini-frame window that is used to house 
the property sheet system 55 window. The property sheet frame 52 allows the property sheet system 55 window and 
40 pages 56 to be operated in an modeless fashion. The property sheet frame 52 creates the property sheet 54, hides 
itself when closed, and provides access methods to its owned property sheet 54. 

The property sheet class 54 provides management support for the key property pages 56. This support indudes 
property page aeation. property page docking support, and property page iqxiate fadlities. 

The individual property pages 56 constitute the final component of the property sheet system 55. Each property 
45 page 56 provides specific edit functions for a portion of the data exchanged with an application program. Each property 
page Is derived from a base property page that provkJes application-specific property page functions. The base prop- 
erty page provides tear-away page support, and facilities to update a keyboard or be updated from a keyboard. The 
base property page also provides an iterative mechanism for setting property information for multiple keys of keypad 
annundator 16 in FIGURE 2 to facilitate disabling of controls. 
so Further elaboration is provided below, in a separate section on each of the components. Class definitions and a 
description of the Instance variables and methods for the property frame dass. property sheet class, and property page 
classes are provided. Important code sections for the property sheet and property page classes are listed at the end of 
the specification, and additional code, including code pertaining to nKxfification of the application frame window dass 
is provkled in an appendix. Coding for the property sheet frame class is not provided. 

55 

Application Frame Window Class 

Coding for portions of the application frame window class is provided in the appendix. 
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Property Sheet Frame Class ■ CPropertySheetFrame:CMiniFrameWnd 

The property sheet fram 52 allows the property sheet system window and pages to be operated in a modeless 
fashion. The property sheet frame 52 can operate to create the property sheet, to hide itself when closed, and provides 
access methods to its owned property sheet. 

As shown in FIGURE 8 and in FIGURE 9A, the CPropertySheetFrame 52 provides the harness window for the 
property sheet system. The CPropertySheetFrame 52 aeates. destroys manages visibility, and facilities modeless 
operation of the property sheet system. 

The CPropertySheetFrame class 52 is defined below in Tables 1 and 2. 

Table 1 - CPropertySheetFrame Class Definition 



20 



25 



30 



35 



40 



Name l^irametcrs RcUirtis .Access Vimia 




UINT 

WV^rCaiCFagcIVLaSK 


Nothing 


public 


no 


^^^^ 


void 


Nothing 


public 


yes 




void 


CACRPropertyShe 
et* 


public 


no 




LPCREATESTRUCT 
IpCreateStruct 


int 


protect 
ed 


no 




void 


void 


protect 
ed 


no 




CWnd* pOidWnd 


void 


protect 
ed 


no 




UINT nState, 
CWnd* pWndOther, 
BOOLbMinimized 


void 


protect 
ed 


no 



45 



Table 2 - CPropertySheetFrame Data Definition 




T>pc Access 


CACRPropertySheet* 


private 


UINT 


private 



Below is a description of the data and methods of the CPropertySheetRame 52. 

D^ta: 

55 m _pACRPropertySheet: This data member is a pointer to the property sheet system that is aeated and managed 
by this frame. 

mjHvCreatePagef^ask: This a data member s the initial page creation mask used to def ine this property sheet sys- 
tem. The page aeation mask Is a bit field that indicates to the property sheet system which property pages to create. 
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Methods: 

CPropertySheetFrame(UINT wCreatePageMask): This method is the constructor for the CPropertySheetFrame 
class. The constructor will store the specified page creation mask internally and use it later during the creation process. 
5 The constructor will initialize the mj)ACRPropertySheet member variable to NULL 

-CPropertySheetFrameQ: This method Is the destructor for the CPropertySheetFrame class. The destructor will 
destroy the m_pACRPropertySheet member variable. 

GetPropertySheetQ: This method returns the mjjACRPropertySheet pointer 

OnCreate(LPCREATESTRUCT IpCreateStruct): This method handles the creation of the frame window. This class 
10 customizes the creation process by creating the property sheet system at this time. The property sheet system is cre- 
ated with the page create mask. m^wCreatePageMask. that was specified during dass creation. 

OnCloseQ: This is a method that intercepts the normal window close behavior. The default behavior of the close 
process is to destroy the window and this class. This method simply hides the window. The destruction of this dass is 
the responsibility of the CACRFrameWindow. 
IS OnSetFocus(CWnd* pOldWnd): This is a method that forwards the focus handling to the embedded property sheet 
system if one is defined. 

OnActivate(UINT nState. CWnd* pWndOther, BOOL bMinimized): This is a method that fonwards the activation 
handling to the embedded property sheet system if one is defined. 

20 Property Sheet Class - CACRPropertySheetiCProDertvSheet 

The CACRPropertySheet 54. Illustrated in FIGURES 8 and 9B. provides support for the key property pages. 
CACRPropertySheet customizes the default property sheet behavior by providing automatic property page creation, 
property page docking support and property page update fecilities. The CACRPropertySheet class 54 is defined below 
25 in Tat)les 3 and 4. 



Table 3 - CACRPropertySheet Class Definition 



30 


Niimc 


Parameters 


Returns 


Access 


Virtua 1 
1 1 


35 


^^^^^^^ 


wPageCreateFlag 


Nothing 


public 


no 






void 


Nothing 


public 


yes 


40 




LPCREATSTRUCT 
IpCreateStruct 


int 


protecte 
d 


no 






UINTwPageMask 


void 


public 


no 








void 


public 


no 


45 




UINTwPageMask 


void 


public 


no 






UINT wPageMask 


BOOL 


public 


no 








UINT 


public 


no 


SO 




^2 UINT wPageMask 


CPropertyPage* 


public 


no 


SS 




UINT wPageMask, 

LPRECT 

pTearOffRect 


void 


public 


no 








void 


public 


no 
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Table 4 - CACRPropertyShcet Type Definitions 



Mask 




Value 






1^0x00000000 






1 0x00000001 






1 0x00000002 






1 0x00000004 






1 0x00000008 




msmm 


1 0x00000010 






i 0x00000020 






1 0x0000003f 






9 OxfiSSIff 



25 

Masks : 

The following masks are used to define property pages that are used in the CACRProperySheet Implementation. 

30 NO_PAGES: Specifies no pages. 

PAGE_ACTIONS: Specifies the Alarm Actions Property Page. 
PAGES_D1SPLAYS: Specifies the Display Property Page. 
PAGE.PROGRAMS: Specifies the Program Property Page. 

55 PAGE_COMMANDS: Specifies the Command Property Page. 

PAGE_ALARM_LIST: Specifies the Alarm List Property Page. 
PAGE_ALARM_COLOR: Specifies the Color Property Page. 
LEGAL_PAGES J)NLY: Specifies all the legal Property Pages. 
ALL_AVAILABLE_PAGES: Specifies all pages, legal or othenvise. 

40 

Methods: 

CACRPropertySheet(CWnd* pWndParent. UINT wPageCreateRag): This is the constructor for the property sheet 
system. The constructor will invoke the CreatePage member with the specified page aeate mask. 
45 -CACRPropertySheetO This is the destructor for CACRPropertySheet. The destructor will delete all ed property 
pages. 

OnCreate(LPCREATESTRUCT IpCreateStruct): The OnCreate handler automatically snaps this window to the cli- 
ent region of its parent, typically the CPropertySheetFrame. 

PostNcDestroyO; This method calls the default PostNcDestroy handler and then deletes itself. 
so CreatePage(UlNT wPageMask): This method will creates the property pages specified by the page mask. All cre- 
ated property pages are automatically added to this property sheet. 

DestroyPage(UlNT wPageMask): This method will find the page with the specified mask, remove it from the prop- 
erty sheet system, and destroy it. The page mask must specify a single page for thus method. 

lsPageEnabled(UINT wPageMask): This method will determine it the page specified by the page mask is present 
55 in this property sheet system. This method will return TRUE if the page is found. FALSE othenwise. 

GetPageMask(void): This method will return th page mask for all the pages ed in this property sheet system. 
FindPage(UINT wPageMask): This method will find the page specified by the page mask. This method will return 
the specified page if it is found. NULL thenvis . 

TearOffPage(UINT wPageMasI^: This method will request the main frame window to create a property sheet sys- 
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10 



tern in the specified page mask, remove the specified page from the property sheet system, and if the property page 
removed is the last on Idll this class. 

UpdatePageControl(void): This method provides a work around to a MFC 3.0 bug concerning the automatic redraw 
of the page control used in the property sheet system. 

Property Page > CACRProDertvPaae: CPropertvPaqe 

The CACRPropertyPage 56. as illustrated in FIGURES 8 and 9C. provides the core behavior for the key property 
sheet system for the process control application program. The key property sheet system is used to configure the keys, 
of the keypad annunciator 16 In FIGURE 2. CACRPropertyPage 56 provides tear-away page support and facilitates set- 
ting of properties from and to a target data source. 

The CACRPropertyPage class is defined below in Tables 5 and 6. 



15 



20 



Table 5 - CACRPropertyPage Class Definition 



Name 



ParanKHcrs 



Returns 



Access \ 
a 



UINT wPagelD, 
UINT nIDTempIate, 
UINT nlDCaption 


Nothing 


public 


no 


LPCSTR 

IpszTemplateName, 
UINT nlDCaption 


Nothing 


public 


no 


void 


Nothing 


public 


yes 


void 


UINT 


public 


no 


void 


void 


public 


yes 


void 


void 


public 


yes 


void 


CACRProper 
tySheet 


public 


no 



HWNDhWnd, void 
LPRECTpRect 

HDC hDC, void 
LPRECT pTrackRect, 
BOOL bKillTrack 

LPRECT pTearOffRect void 



UINTnFlags, CPoint void 
point 

UINTnFlags, CPoint void 
point 

UINT nFlags, CPoint void 
point 



protecte no 
d 

protecte no 
d 



protecte no 
d 

protecte no 
d 

protecte no 
d 

protecte no 
d 
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Table 6 - CACRPropertyPage Data Definition 




Data : 

m^rTrackRect: This variable s the property page tracking rectangle during a page tear operation. 
m.blsTracking: This variable indicates that the property page is in the process of being torn off. 
m_blsTearable: This variable indicates that the cun'ent property page is tearable. 

m_bDitherLast: This variable indicates the state of the last drag track render operation. To maximize visibility the 
track rectangle is rendered in a combination of dithered states and non-dithered states. 

m_8izeLast: This variable s the size of the last track render operation. 

m^rectLast: This variable s the rectangle that was previously rendered during the drag operation. 

mjstStartPoint: This variable s the starting point of the drag operation. The start point will maintain the relative posi- 
tion of the drag rectangle to the mouse. 

m.wPagelD: This variable s the page id of this property page. The page id is defined on creation of the property 
page. 

Methods: 

CACRPropertyPage(UINT wPagelD.UINT nlDTemplate.UINT nIDCaption): This Is the constructor for the 
CACRPropertyPage dialog. The constructor requires specification of the page ID. a dialog template, and a caption. 

CACRPropertyPage(UINT wPagelD .LPCSTR lpszTemplateName.UINT nIDCaption): This is a constructor for the 
CACRPropertyPage dialog. This version of the constructor allows for the specif ication of the template using a string. 
CACRPropertyPageQ: This is the destructor for the CACRPropertyPage dass. 

GetPagelD(void): This method returns the mjwPagelD member variable. 

BeginPropertySet(voicl): TNs method provides a hook for derived property page classes to initialize data state 
information to property reflect data values under multiple keys. 

EndPropertySet(void): This method provides a hook for derived property pages to end the property setting process 
by reflecting collected state information into the property page controls. 

GetPropertySheet(void): This method returns the parent property sheet. This method will ASSERT if the parent 
property sheet is not of CACRPropertySheet style. 

CllpReclToWindow(HWND hWnd.LPRECT pRect): This method will clip the specified rectangle to the specified 
window. The method will maintain the size of the specified rectangle if possible. 

Track(HDC hDC.LPRECT pTrackRectBOOL bKillTrack=FALSE): This method performs tracking for the property 
page dragAear operation. 

TearOffDialog(LPRECT pTearOff Rect): This method performs the property page tear operation. It determines K the 
specified rectangle represents a tearable state and if so performs the tear operation. 

OnLButtonDown(UiNT nRags. CPoint point): This method handles the left mouse button down processing. This 
method will start the property page tear operation. 

OnLButtonUp(UINT nFlags. CPoint point): This method handles the left mouse button up processing. This method 
will end the property page tear operation. 

OnMouseMove(UINT nRags. CPoint point): This method handles mouse move processing. This method will drag 
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the page tear r ctangle if the mouse button is pressed and the page tear operation is underway. 



Key Property Pages 



10 



In the application described here, wherein the property pages are used to exchange information about, and to con- 
figure, the keys of keypad annunciator 16 in FIGURE 2. the key property pages are derived from the CACRProper- 
tyPage base dass. as shown in FIGURE 10. The property pages provide specific edit operations for the key data. 

Each property page will be implemented in a similar feshion. In general, each property page will provide the follow- 
ing interface, as set forth in Table 7. 



Table 7 - CACRGenericEditPage Class Definition 



Name 



Parameters 



Rciums 



Access Virtu 



15 



20 



UINT wPagelD, 
UINT nIDTemplate, 
UINT nIDCaption 

LPCSTR 

IpszTemplateName, 
UINT nIDCaption 

void 



void 
void 



Nodiing public no 



Nodiing public no 



Nothing public yes 



void 
void 



public yes 
public yes 




35 Code sections for the property sheet and property page classes, as well as code sections pertaining to modification 
of the application frame window class, are provided in an appendix. The code is written in the C++ programming lan- 
guage, but can be used as the operational foundation for other implementations. 



40 



45 



so 



55 
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APPENDIX 



C-M- Code for CACRProp ertySheet Class 



//•••••••• * ' 

n • • • • * 

// 

// Cl&ss: CcvAtePage 

// Description: Creace the pcopercy p*9e for thl» svisk «nd «dd It to th« aysc«n. 
// This routine will creAte nultiple pa^es ie aultiplt masks arc 

// specified. 

// 

// Returns: Bool 

// 

// • • • 

1 CXodelessPtopertySheee::CceatePa9e(0IMT vPageHask) 
CPcopcrtyPaqe* pPA^e; 



// Oecenaint IC the individual page types 

// ace defined and create and add then to the 



// sheet. 

iC (wPageMAsk & PACC.ACTXONS) 

pPage • new CAlciAetions () ; 
AddPa^elpPage): 

I 

if (vPa^eiiask & PACC.OtSPtAYSI 

\ .... 
ppa9e - new COisplayListPageO : 
AddPaqeCpPa^*)' 
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if {wPageMajk C PACE PAOCltMISl 
I 

pPaq* - nev CProgcuiLiitPagttO i 
MdP«geCpP49e); 

5 ' 

IC (wp«9eiusk 4 PACe COCMAHOSI 
( 

pp*9e - a«w CCoBSMiulOigO } 

if (up*geMask ( PACE ALARM tXST) 
( 

pPag* • new CAUnLUcO? 
10 AddP«g«<ppAge)« 
I 

if <wP«9«Kask & PACE ALAWl COIOR) 
C 



IS 



20 



35 



40 



I 

I 



pp«9e - new CKewAlanCoIor (> ; 
AddP«g«(pPA9e)i 



iethod: DeatroyP«ge 
.. Description: Thla acchod coasts the property pjge associated with this aask. 
// *tnl» t* used When « property page has been reaoved Ctoa one sheet 

// and put into another sheet. 

// 

// Returns: Bool 
// 

// • 

void CHodeie9SPropectySheet::OestroyPage(UIHT wPageKask] 
CPropertyPage* pPropertyPage; 

25 n 

// G<t Ic. Remove It. KILL It. 

// 

if (IpPropertyPaye - rindPage(wpageKaskM !- NULL) 

RenovcP»9e (pPropercyPage) ; 
delete pPropertyPage; 

30 } 



// 

// 

// 

// Class: FindPage 

// Description: Get the property page pointer based on a nask 

// Returns: Bool 
// 

// • • • • 

epertyPage* CModeiessPropcrtySheeC: : TindPage |UIN7 wpage.*iask} 

CACRPropPage* pPage - HULL; 

£or (inc i«0; KCetPageCoont ( ) ; i««) 
I 

// An Z the guy wo want? 



45 //•••••••♦•••••••••••••,■ 



50 



^^•••** • - - 

// Class: CModelessPropertySheet 

// Description: This define, the core Mdeless property shcec. 
// 
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•fine 

•defiiM 
- Idaftnt 
•Minn 
f<t«Cla« 
Idcfla* 



NO rACCS 
PACE MCTZONS 
PACC'DISPUUfS 
PACC^PROCAJVHS • 
PAGE COMMANDS 
PAGC^AIABM LIST 
PAGBJOAfUtjCOLOR 



OkOOQOOOOO 
OxOOOOOOOI 
OjcOOOOOOOZ 
0x00000004 
0x00000008 
OxQOOOOOlO 
0x00000020 



•iCdaf SOrrPAMEL 

•defin* LEGAL PACES ONLY 0x00000D3£ 
AU^AVAXIABLK^PACCS Mttttttt 



•defUe 

f«i«t 

•d««iiit 
IdtCine 
itndif 



LEGAL PACtSJMLY OxOOOOOOK 
ALLX^AllASLe.PACES Oxtfttttdt 



cUas Otod«Les3PcopertySh««c; 
cUts CKaybMcdCor*: 
el ASS CACRXeyi 



IS 



20 



class OtodtltssPropcrtySheet : public CPropercyShest 
privste: 

CXeytoosrdCere* m ^^pOwnerXeyboard; 
public: 

OCCLAAC^DYVAMZC tCModttlcs sPcopercySheeC) 
" CModeles3Pcoperey$he«t 
-CModeL«ssPcopertyShett 



jCHnd* p«ndP*renc,OIOT wPsgeCreaceFla?) ; 



// Attributes 
void 
void 
SOOL 
•J I ST 

CPcopertyPagt* 

void 

void 

void 



CreatePsge 
DescroyPage 
ZsPaqcCn&bled 
CecPageHask 
rindPaqe 
ToacOf CPage 
UpdataPagaConcrol 

SetPropacciasrcoaXeyboard (CKeyboardCore* pxeyboardl ; 



(UXHT wPegeMask); 
(UIHT wPaqeMask); 
(UIKT upagcHask); 
(void) ; 

(UIUT wPageKask); 

<OINT wpageMask,LPR£Ct pTeacOeCAeecl ; 
(voidl ; 



I CCpPage - (CACRPropPage-)CetPagea) } !- HULLJ &4 
(pPage«>taKir.dO£(RUMTZKC CLASS (CACRPropPagel ) > U 
(pPage->CecPa90lD() t wPageMaskl t 



SO 



return pPage; 



I 

ASSENT (?PagQ !- s 



return pPage.* 



// le wt act asking for a KULt page 
// bogus is going on. 



55 



40 



45 



II 

✓/ 

II 

II Class: 

// Description: 

II 

It 

II Returns: 
It 

II 



IsPageEnabled 

This routine loops through Che pages associated with this 
dialog sysceai and deteraines iC they are present. 



Bool 



BOOL CladelessPropcrtySheet: xXaPageCnabledfUIRr weageMask) 



I 



CACltPropPage* pPage • HULL; 
£or (Lnt i-O; KCetPageCouncO : 



7/ Aa t the guy we wane? 
if t ((pPage - (CACRPropPage*)GetPage(i) | !- HOLL) &4 
(pPage->lsKindOf(RUNTZKe CLASS(CMCRPropPage))) u 
(pPa9e*>Oet Page too & wpageMask) ) 

i 

return TRUE; 



50 



return FALSE? 
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10 



IS 



20 



35 



SO 



55 



// ' 

// 

// 

// CX*ii: C«c?«9«M««k 

// Dcvcrlpclon: TlUi coutlno loops thcouyti cho pA^mM AJsoci«Ct4 with i 
// dialog syscm and collvecj their p«9« M«kj. 

// Ra turns: uxht 
// 

// • • ••• 

UZNT CKatf«ltsiPropectySh««t: xCstPsgclUaltlvoldl 

OINT wpaQclUsk - 0; 

CACRPropPA^e* pPage - HULL; 

Cor (Inc 1*0; KCctPageCount O / 
i 

// An I th* 9ay va wi.at7 
if ( {(pPage - (CACRPropPaga'ICatPaged)) I- mru.} 4( 
(pPa9e>>IaKind0f CROHTXKE_CtASS {CACRPcopPAga) 1 1 | 
vPageKiak |* pPAge->C«tPa9eXD()i 

satura vPageKaaki 



//• 



ClAss: PageOtangad 
// Oeaccipcion: Thli routtne is called by th« Property pages when sooethlng 
// ha J oceured thac changes their data. Ut mIII cell the ka^acd 

// core so he nay update his infomation. 

// Returns: Nothing 



25 //. 



// 

// Method: TearOffpage 

// Description: This routine reaovaa the requested page fron this sheet 
*«>^ cells the frane to create a ncv one. 



// Returns: Nothing 
50 // 



d CKodelessPropercySheec::tearOffPage(UXHT wpageMask^LPRCCT pTearoetReet) 

crraiteWnd- pKewrr*ne; 

tl) \i iiSr^"** " iCrca««Wnd-)ACRCetMainHiivdo«()->AddPropertySh«tt(Cat0waerKeyboArd(),wPageHask,p7ear0t 

i 



// Xe it is the lest page we should coisait 
// sttcide 

// . 

if (CetPageCountU — II 



Cct?areAt(l->OestroyMindow|l ; 

// 



40 // Get It. Reaove It. KXZX It. 

// 

else 
1 

DeatroyPaqe (wPageHeskt ; 



// 

// Put the new one on top 



45 li (pNewrrame !- (CFraaaWnd'lGetParent () } 

pNawrra(ie->BringWlndowToTop() ; 
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//••••• • 

// 

// MethiMl: Up^tcPageConcrol 

// 0«9celption: TM» o«thod forces the contcoL used In the ptopecty p*9e» to 
c // be ccdrtwn. 

* // 

// Rotucns: Kothtn9 

// 

// • 

void CKodelesaPcopettyShoeC: :Upd«e«P«geConcxoI (void) 

( 

a t«bRow.S«tCucScL(tt tabRow.CocZwaCount O-D ; 

10 ) 



IS 



C-H- Code for r ACRPronertvPage Class 



20 



II 

// • 

// 

// Class: CACAPco?»&9e 

// OcserLptlen: This deSlnes the «lam color dialog. 
// 

// 



25 



cIass CKeybosrdCore; 

class CACRXey; 

class CModelessPrspertySheet: 

class CACIUtocuaenc; 

class CACRPropP«9e : pualic C?copercyPaqe 
CSCLMU: DYtIA.MICtCAC?.?rop?a9e) 



50 



protected: 
RECT 
BOOL 
BOOL 
BOOL 
SIIE 
RECT 
POINT 
UINT 
BOOL 
BOOL 



•■s^rtrackRect; 
a'blaTrackinq; 
::;2bIsT««rabI«: 
rrbOitharLast; 

n^tectt-ist; 

n~pcSt*rtPoint; 

at^wFiqelD; 

o~bCr.*bleTcACking ; 

Q^SelectedKeyCount; 

a*'b:sXnitedi 



// Systea defined uier a«sk 



35 



40 



45 



// Co.iscructxon 
public: 



victual BOOL 
virtual BOOL 
UlNT 

virtual void 
victual void 



virtual void 
virtual void 
virtual void 
virtual void 
victual UtNT 



CACRProp?«9« 
CACRPropPag* 
-CACP.PropPage 

OnSct Active 

CanCLose 

CetPagetO 

Se t Propar t i« s r roaXe yboa cd 
Se txe yboa cdPr eaP cope c t le s 



BeginPropeccySet 

SetPropertyrrooJCey 

SetKeyrroffiProperty^ 

End? rape rtySet 

Ce tUndoOpe rat ioa ID 



CKodelessPropertySheet* CetPropertySheet 
CACKDocuDent* CetCocuaenc 
Clc«yboacdCorc* Get Keyboard 



(OINT wpagelO.UINT nlDTe.-plate.UlMT nlOCaption-Ol » 

(LPCSTR IpsxTeaplateNaae.UXKT nIOCaption); 

O; 

().* 

(voidM return TRUE;}; 
CvoidI; 

(CKeyboardCore* pKoyboard): 
(CXoyboardCore* pKeyboard«LO{lC IHint-OL) f 

(void) ( I % 

(CACRKey pKeyJO 

(CACRKey* pXey.LONC lHint-0)(l 

(void) ( ) 

ILOKC iHintX return StR^IO^EOlT^UKOO; ) ; 

(void) ; 
(void) ; 
(void) ; 



// Dialog Data 

// ( ( ArX_OAT^(CACR?ropPage I 



50 
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//J ) AnC^OAT^ 



// Ovtrrides 



proceeded: 
//» }XFX_VXRTUM, 



// XnpltmntAtXon 
protecc«<t: 

void 

void 

void 



); 



CllpRectToWindow 
TrAck 

TcarOffOialo9 



// Generated aeuage lup functioiu 
//{(AFX MSC{CACRPropP«g«| 
virtual BOOL OnlnitOialog 
AtxjMsq void OnLButconOown 
4£x_nsg void OntButtonOp 
afx^Biag void OnMoujeMove 
//) )MX KSC 
DECLAiU:~«ESSACE^KAP { J 



iniin, UIMT «CRProp?aqe: :CecP«5eI0(void) 

^ return a^wpageZO; 

lendif 



(HWO hWnd,WR£CT pRectJ • 



Or 



Inltl point), 

mSJ ''rj*'*' ^^^'^t 

(UXHI nriags, CPoine point), 



// r 

// 

// 

// Method: CACR?ropPAge::CACRPropPa9e 

// Description: This routine constructs the ACFC Property Page 
Returns: HothiAC 

// 

// 



CACRPropPa9e::CACRPrcpPa9e(UXI)T vpagelOtUIKT nXDTe&pIate.UXMT nIOCaptlon) 
on) 



CPropertyPage (nZOTenpiate.nXOC 



ia_MP45eID 
m~bEr.ableTracV.i 
Bv'blsTrackip.y 
B^^IsTearable 
ra'bOttherLasc 
m'sizeLast.cx _ 
: Is e t Re c t Cap t y ( ta_re c t Lasc) 
Q_SeiectedJCeyCocns - 0; 
n bislnited • TALSC 



- uPagelD; 

- TALSG; 

- FALSE; 

- FM^C; 

- fALSC; 
• m^siseLAst .cy 



//( |Anc_OATA__XNlT (CACRPropPage) 

// NOTSi^the ClassWiiard viil add aecefcer initialization here 
//DAFX DATA IK:7 



// 

// 

// 

// Method: CACRPropPage: :CACRPropPage 

// Description: This routine constructs the ACrC Property Page 

// Returns i Nothing 
// 

// • 

"APropPagetiCACKPcopPagefLPCSTR IpszTenpUttKame.UtMT nIDCaptlon) : CPropertyPag«(lpa&Tevpiate!)amo,nXOC 

I 

// ( ( AFX^OATA^INIT (CACRPropPaqe) 

// H07e:'~the ClassVixard will add oenber Lnitiaiization here 
//DAnC CATA :SIT 

I 
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ft • ♦ ••••• • , 

// •••••••*»•••• 

// CUi$: OnLBuceonOown 

// Ovscription: Te»r Away this popup «nd a«k« « M<l*less dialog ogc of It . 

// Returns: BOOL 
// 

// « , 

void CM:%P£opPa9e::OaLButtonOown(UZHT nrU9s« Cfoint point} 

HiWO hOeskcop - ::G«eDc3ktopWlodow(|/ 

le (Cet?ftrenc()->IsHindowVlsibl«(] « hOesktop) 

HOC hoc - ::GecOCE]C(hOejktop«tlOLL,DCX_PA]l£NTCLIP); 

// Reodtr Che popup eutiiae 
CecCUentRect (&in_rTrackIl«cc) I 

: :KipWlndowPointa (CetSar«»md{) .hOesktop, (LPPOIMT) (m cTreekR«ct.2) * 
Bi_ptSt*rt Point • point; ~ 
a_bl4Tr«ckin7 - TROC; 
•[[blstcACAbla - FALSC; 
B^^bOitherLASt - nosc; 
:Ts«CR«ccCapty {4a_cttetL«st) ; 

a^sizeUse.cx - o^sixeLaat.cy - 0; 

: : SetCaptuce (6ec5« feHwnd ( » ) ; 

// Render the popup outline 
7re=k(hOC, &a_cT»ckRect) ? 

// Release the display contek 
: :fteleA3«OC(hOesktop,hDC) ; 

elae 

CPropeccyPage: :OnL8uttonDown(&FXa9s. pointi ; 



// • 

//•••• • 

// 

// Class: OntButtonUp 

// Description: If trackin9 a popup ruke a modeUss dialog out of it. 

// Retunis: BOOL 
// 

// , 

void CACR?co??a9e::OnLButtonOp(OlMT nflagsr CPoint point) 

if {a_bIsTrackin9) 

RSC7 rClientReet; 
SecCXientRect<(rClientRect| ; 
HWNO hOesktOp - : :GeCOcskCopKindOw(|; 
HOC hOCi 

ASSCRtthDesktopu 

hoc • : : Ce t OCCx (hOe skt op, WILL, DCX^PARCKTCLtP) ; 

// Undraw and relasse dc 

?r*ck IhOC. C9.rTrackR«et,TRUe) ; 

: :BilcaseOC(hD«skcop,hDCl j 



// Crest* the sodeless property 
// sheet dialog here, 
if {(a_bIsT*srsbl«) 4( ! : :?tXnRect ((rClientRect,a_pt$tactPointn 
TearOff0ialo9(ta_ETrackRectW 
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B_bXaTnekin9 - nosC; 
: :ReXc«aeC«pture<) f 

eXse 

^ CProptrtyPage::OnL8uttonUp(nrU9S, point) i 



// • 



•••••••••••• 



// Cl4ss: OnHouaeKove 

// Description: Track the popup Lt it being torn away. 

// Rttoms: BOOL 
// 

//•♦ ^ 

void CACIlProp?a9e::OnMouaeMovc<UINT nriaga, CPolnt point) 

RCCT rCilentRcctJ 

GetClientRact (ftrCXionCRect) / 
iC (a_bl9Traelcln«) 

KWNO hOoaktop - : :CctOesktop«indowO; 
HOC hDC> 

ASSERT (hOeskcop); 

hoc - ::G«cOC£«(hDe3ktOp,HULL«OCX_PIUieNTCt.:P); 

if <! ::PcXnRect((tCll«ntReet, point) ) 

iTiZ nDX,nDY; 

// If (n^blsTearable) 

Track()»OC< 4o_rTr«ckR€ctl : // Undriw 

, ^ R«c«lcul*t« the cc*cking tectangle 

nDX • point. X - m ^tStarcPoinc.x.* * 
nor - point. y - n^tStartPeint.y/ 

: :C2f sctRect (&a_rTrackRect* nOX« nOt) ; 
CiipRectToWindow (hOeaktop, 4B_cTrackReet) / 

a_ptStartPoint - point: // Reneber this point 

7r«ck(hOC«(B_cTrackRtct) ; // Redrav 
:: ReieaaeOC (hOeaktop. hOC); // Releaae 

:a bUTcarable - TRUC; 

) 

else i£ (n bIsTearable) 

I 

7rack(h0C«(A rTrackReet.TRUC) ; // Undcaw 
a blaTearablc - FMSE; 

) 

) 

eiae 

^ C?ropertyPaqe::OnMouaeKov«(nriB9a. point); 



•define CX 30:iOER 1 
I define CT~BOiUieR 1 

•deeine TX7LCHSXGHT 16 

// • 

// 

// Claas: Track 

// Oeacription: Render the tracking rectangle in XMOR node on the apeclCled 
display context. 

// Returna: BOOL 
// 

// 



Copyright 1996, The Foxboro Company 



20 



EP 0 813 139 A2 



10 



IS 



30 



SO 



55 



^»l<» CACRPcopP«q«::Tr*c)c(HOC hbc«I.»R£Cr pT«*ckRecc.BOOt bKllLTr«ck) 

COC • pOC-CX : : FroaHAfldl* (hOC) ; , 

<le£4ult Co' thin fr«M 
CSlie 3lt« (CX_BOROCR, CY_80Sa)£R); 

// deteninc new rccc and site 

CRecc r«ct; 

C8r\»»h» pWhlteBniih - C8ni»hj :rcoaH*ndle((HBIlOSKJ : iC^tStoekObieetiiniw ..r..^. . 

CBmsh* pBru3h «• pWtilteBruah/ 
KCJRSOA hCursori 

// Sec track rtct sist 

t«ct - *pTrackRect; 

// aU«***^^*' ^' *" * docking 



if (ACBCetll«inirindo«fO->C*nOecl(Ur«ctt NOtt) 

siM.cjc - GecSyateflrifetricXSH CXfMMEl • CX BOROClli 
sise.cy • G«tSy«tMMetrles(SMjCYntMai - CT^ftOROCR; 

pBcush « pOitherBruah; 



) 

«lst 



20 



2S ) 



KCfcwais «■ purine KPrusnf 

hCucsor - AfKGecAppO->Lo«dCucjor(ZDCHOmcxcO}{ 

i 

hCursoe - A£«CetA|tp()->LoAdCuraor(IDCOOC]CSO]i 
1< {blCUITr«ck M ltt.bZaT««rAbi«) 

sitt.cx ■ siftc.cy • 0; 
^ hCutsor - AfxG«tApp()->Lo«dStAndardCursoz(ZKJUUlOH); 
: :SetCursor (hCucsor) / 

// draw it and rtaeoibcr last 3iie 

p9C>>0r«wDcaqR*cc(4rcct« Site, (a.ceccUst, m slsaLaat, 

p8rush« n.bDithtrUac ? pOitharBrush : pKhireBrushi • 
a.raccUsc - race; *^ . 

a^siteUst - siza; 

a^bOLchcrLaac - (pBrush — pDLtherBmah) 



// • • ^ 

// Class: ClipRectTeWindew 

// Description: ;^^J^^«"tina clips tha spici£iad ractanqla to the spacifitd 

// Returns: BOOL 
// 

// 

voLd CACRPcopP«9e: :ClipRectTo«lndo»#(HWNO hWnd^LFRCCT pRcct) 



RECT rCIicncRect; 
^ inc nWldth,nHetqht; 

•ifndef WU_A?P 

: iCctcIiantRecc (hWnd, (rClientRect) i 

: iGetWindowReet (hWnd, 4rClieAtRcccl i 

nWidth - pRect->ri9ht - pRect->l«Cc/ 
4(j nHelght - pRaec->boctoo - pReet->top; 



// Clip top aod bottoia 



if tpRect->eop < ECllentRact.tepl 

pRect->eep - zClientRect.cop; 
^ ^ pReec->bettoa - pReet->top ♦ nMaight; 

else i« (pRcct->boctoa > cCIicntRect .bottom) 

pReet->bottoa - rClientRect.bottomi 
^ pRect->top - pRect->boetoa - nKeightt 
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// Clip lefc end right 
if (pRect*>I«{t < iCLUotRect.Ieft} 
( 

pRect->le£t - rCUencR«cc.left; 
plUct«>ri9ht - pll«cc->laft ♦ iMidth; 

) 

else Lt (pAecc->ri9ht > rCllcncRect.cLgKc) 
I 

pRect->clght - rCltentRect . tight* 
pR«ec*>l«et - pRftCC->ci.9>»C - ntfLdthi 

) 



// • ' ♦ •* • 

//•*••••••••• • • 

// 

// ClASs: Tc«r0£f0i4lo9 

// Descrlpcion: This routine creates another version of this dialog^ only tn 
// Modeless font. 

IS // 

// Returns: BOOL 
// 

// • • 

tdefine MIK HtW^OELTWt 5 
»de£ine MIh2nCW_CU.7AY 5 

20 d CACRPropPa9e:;TearOf£0ialog(LPRCCT pTearOf fReet) 

t 

MVMD hOesktop - : :GetDo9ktopWLndouO ; 

RCCT rClientRect; 

QtodelessPropeecySheet* pPcopertyShect - CetPropectySheetO ; 

// 

// Convert ctia client coords to the 
_ // desktop coocds to deternine it the 

^ // tracking wlnOaw has nov«d enough to 

// tear it off. 

// 

CetCllentiiectl&rClientRect) ; 

: :HapUindouPoints (CetSafeHwnd U .hOesktop. (L^POIKTI (rCllentReet. 2) : 

// - - 

// Get this pagts I0» create a new property 
30 // Aheet with it. and destroy the page. 

// - 

if (pPropercySheec] 

pPropertySheeC*>TearOf£Page (CetPageXDO .pTeaiOftRect) : 

) 



40 



35 n • 

// 

// 

// Class: CetPropertySheet 

// Description: This routine returns the parent property sheet in a digestable 

// f emat . 

// 

// Returns: 800L 

// 

CModelessPropertySheef CACRPropPagc: iCetPropertySheet (void) 
{ 

C4nd* pWnd - CetParentO; 

CKodelessPropertySheet* pPcopertyShcet; 

• return ppropertySheet; 
return KULL; 



50 
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C^Code for Anp»ir^H>.« g 



10 



15 



20 



// • 

// 

// 

//.Kvthod: MdPcopcccyShcec 

// Ottscrlpcion: This roucinc creates * fr«»« window witti pcopcrcy shctc* &ntf 
// populACts it vith 4vftiUbi« pcopttcty p«q«a* 

// 

// Aeeurnj: CProp«rtyShe«trr*a«* 

// 

CPropeccyShtatrrAM* CJCUUinrcame: :AddProp«rcyShi«c(CKeyboArdCor«* pAcciv«K«ybo«rd.UINr wPa^tiUsk, lpreCT ppco 

pcccyHecc) 

I 

CPropertySheetFtattft* pPropereyShtetPrace-iiniLL; 

//A v«lid 1ccybo«cd is r«c(air*4 

ASSCAr(pActlveK«ybo4rd !• MULL): 

// It the user i« ere«ting a standard property Cr«ne 
// ve should 9ivc then «I1 the Av«ii«ble p«9e* 

w?«qeM4sk - C«cAv»ilabl«PageHaskt) ; 

if twPjgeM4»k — KO_PACCS) 
return FALSE: " 



// Oetemlne i,e we C4n dock this sheet to «n existing 
// tsene. u« «re in docking node it the pPropersyRecc is 
// speciCi-ed. 

if ipPropectyRcct it I (p?ropertySheetrra:ac-C*nOock(pPropertyReccJ I i» MULL)) 

i 

CHodeXe>sProperv/5he«t* pProptrtySheei « p?ropertySheetrrsn«*>Ccc?ropertySheec|) ; 

pPropercyShett'>Cre4teP4ge(vp«geKs9k) ; 
lifndef DOIITRCIMXT 

pPcopeccyShe«c->S«s3w3erKeybo*rdtpActiveKaybo*rd) ; 
2S pPropcrtyShceoSetPrapectiesrroaKeyboardlpAcciveKeytvosrd) ; 

lendi£ 

pProper;yShce:->'JpdstePi9eControl n « 

) 

else 
( 

// Uazch out for those enceptoins 

TM 

30 CRecC ttctlO.0.0,0) ; 

CString strTitle: 

// Create this guy «nd position it. 
p Proper tySheetrrar.e - new CPcopercySheecrr4ae(wp«geMask); 

StrTitle. ^pcy<j ; 

„ if (!pProp«rtySheccrr4ne->Cr*4t*(t<ULL, SCCTitle.HS^POPUP t WSjCApTlQM ) US SYSMCNU, ceCC, thisM 

33 delete pPrspertyShcetFcane: ~ " 

VpdateXeyPr3pertyTitle(pPropertySh«etFr4ne,pAetiveKeybOArdl ; 

// Initialise Che data 
pPropcrtyShee:rra:ie->CetPropertySheet O ~>S«tOwnerKeybo4rd(pActiveKeybo4rd) : 
pPtoperty$heetFrase->Get Proper tySheet O ~>SttPrepertiesFtomKeybo4rd(pActiveKeyboetd) ; 

40 // If 4. property rect is specified use it to 

// position this guy 

i£ (pPropercyftect) 

p?roper^yS^«*trr4eic->SetWindovpos(NULL,pPrepettyRect*>l«rt,pp;opcrtyRecf>top.O.O,SWp HOSIZCIS 
WP^S010RD£R| ; ~ 
else 

pPreperv/Shee^rr4mc>>Ccntecwindo«'(ACRCetOialogCenterWindow(| | / 

it (lpPropettyShe«trrAaie->l5Windo«*viaible(l > ' " 

45 pProptftySheetrc4ne->Show«indow<SW_SKOW| s 
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TO 
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SO 



' deleta pPropcrt3fShcetrrAm«; 
ctcusn pProp«rtySlio«trr*iw/ 

I 



••••***** •••♦•#••••••••••••••••••••••••••••••*♦•••••••••••••••••• 

/j 5«scriPCtott: ThiJ routine caIcuUms xh» •v»ll»ble pa^s Msks by enuaerACing 
•11 Che child property f rases. 



i. Returns: OXHT 

// 



OlMT CACWUinrr*»e: :C«tAi»4ll«blePAqeM*»k(voi<l) 
cwna* pwnd - this; 

// Loop through «11 the child window «nd 2ind chc 
// fraees and add their Paqe Kaak to this page mask. 

while (pUnd) 

* if ( {pMnd->l»ian<SOtlRUMTIMEjaASS|CPropertySheetrrame))l C( 
(pWnd-X:etParentl)->GetSa£eHwndO CetSafeHwndO ) I 

* CPropectySheetrcame* pPropertyFtane - tCPcopeetySheetrcaoe'lpWad; 

CModelessPropectySheet* pPcopSheec - p?ropertyframB->CetPropectyShett() * 

wPageMask 4- -pPropSheet->GetPageMask() ; 

25 ) 

pwnd - pWad->CetMextWindow(CT^SWNOPREV| J 

Uturr. vPaqeHask; 



«, 

// 

// Method: CanOock . ^ * 

// CescrLption: Thta couclne deterwines if we dock the «pecill«d frame co 
an existing frame. 

// ?.ituca$: CPropertySheetrtaae* -> Oockinq frame If one if found. 

// , 

35 // 

Idefine 0OCIOC_rU2l 10 
^derine DOCKt_rUZZ 10 

CPropertySheetrrame* CACIWainframe: :CanOock(LPRECT pPcopertyRecc) 

CPropectySheetrrame* ppropectySheetrraaa-HULI,; 

^ 'jl^*^ ^ wPaqeMask • LCCAL.PAGESJONIY; 

Oind* P»nd - this; 

arcT rTestReet - *pPropertyRtct; 

// reduce the test reet 
: t :nf lateftect (fcrTeatRect, -OOaajTIZZ.-OOCKY^FOttl i 

4S // Loop through all the child window snd find the 

// frames and add their Page Hask to this page mask. 

while (ptfndl 

* if { (p«nd->IsKlndOf lRWTXIttjCtASS<CProperty5heetrra»en» 
(plind»>CetParentO->Get$aCeKwnd(l — CetSaf eKwnd 0 ) I 

I 

RGCT rHindowRect; 
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(r«lndowRect,le?t < rtUtM«!JJitJ .l^iSfJ^*:?^-*^'^^ > --TescRtct. bottom, 
^ return (CPtoptrtyShtctrrai^rpHiS; ^'"^'"lo^^ecc. tight > rf.clU^TnSSti 



^ pWnd - pttn<l->C«tKBXtHllldOi#(CW_HimOPRCV»; 
return HULL.* 



// ' 

// 

// M«tho4; SyncProp«rtySh«ot» 

// Descriptioa: This coutint syncs th« proposty sheets up with the current 

// selection state oC the keyboard. 

// 

// Returns: Nothing 
// 

// " 

void CACRMeinrraae::SyncPrQperty5he«ts(CKeybosrdCor«* pKeyboerdI 

// Cec the Accive keyboard if one is not specified. 

it (!pXeyboardl 

pKeyboard - CetActlvcKeybOArdO ; 

// Sync each property frane if a keyboard Is 

// specified. 

if :pKsybeardl 

r?jy«.2 ?3SITIO*iiHro rr a«ie ?ositionXnfo; 
rr*r.ePoiiCioftrn£o.h«indowOoTopOf - K«h6_T0P/ 

rraceP9SitionIn£o.hDeferPositionInfo • : :BeqinO«fettf indouPosCO) ; 
rcAscPositionZnfo.hParent - GetSafeHvndd ; 

rraaePositionZnfo.pKeyboard - pKeyboacd} 

mn«?03LcicAln£o*bZnvaIld«te - TALSC; 

rr«£e Posit lonZnfo.pScretnRecc - WLl,: 

rraxePositionlnfo.vPcopHode • kPropSyne: 

: :£n'^Mindows (ACR£nuAChildPcoc, (LPARAH)trr«ae Posit ion Info) ; 

if IcranePosltionlnfo.hOeferPositiontnfo) 

: lEndOefsrUindoifPos (FraaePositionlnfo.hOeferPositionlnfo) ; 

) 



// 

// 

// 

// Method: ClosePropertySheets 

// Descripticr.: This method «nuiaer*c«s each property sheet and =losts then. 

// Retu;.*.s: Hothino 
// 

// • 

void CACKKair.rraae: :ClosePcopettySheQtJ (void) 
I 

// Sync ««ch property (caM if a keyboard is 
// specified. 
rRAME?CS:7X0HINrO rraoePosiCionlnfo/ 

Be&s«r { &?rai&ePositionInfo. 0, siieof (FraAePesitloAtnfot ) ; 

FranePositionZnfo.hWiAdowOnTopOf - khmo TOP; 
rraaePositionZnfo.hOefarPositiontnfo - WJliJ 

rraBaPesitionXnfo.hPsrenc • GctSaCeamiddi 

rraxe Posit ion Xnfo.pKeyboard - HULL; 

rraatePositiontnfo.bSnvalidAte • PALSC: 

trasePositiontnfo.pScreenReet • NOLI; 

rraaePositiontnfo.wPropHode •> kPropClose; 

: :Sr.MsUir.dous (ACRCnuaChildProc. (LPARAMl (rrantPositionZnf o) ; 

I 
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Claims 

1 . Apparatus for computerised data processing, comprising 

5 processor means for executing a program, 

a memory element for storing the program, 
a display monitor for providing a display, 

selection means for selecting a property page of a first property sheet system, the first property sheet system 
including at least one property page displayabie at a first position on the display monitor, and 
10 creation means for creating a second property sheet system including said selected property page, said 

selected property page being displayabie at a second display position on the display monitor. 

2. Apparatus for configuring a peripheral via a computer or configuring the intercommunication between a computer 
and a peripheral, the computer comprising; 

IS 

processor means for executing a program, 

a memory element for storing at least the program, 

a display monitor for providing a display, 

the processor means being adapted to display via the display monitor property sheet systems for receiving 
20 configuration settings data from a user, the processor means being further adapted to store said data in the 

memory element at least temporarily and to employ said data when communicating with the peripheral: 
selection means for selecting a property page of a first property sheet system, the first property sheet system 
including at least one property page displayabie at a first position on the display monitor, and 
creation means for creating a second property sheet system including said selected property page, said 
25 selected property page being displayabie at a second display position on the display monitor. 

3. The apparatus of Claim 1 or Claim 2 further including 

removal means for removing said property page selected by said selection means from said first property 
30 sheet system such that said selected property page is not displayabie by said first property sheet system. 

4. The apparatus of Claim 3 further including 

destruction means for destroying said first property sheet system when said first property sheet system does 
35 not Include any property pages. 

5. The apparatus of any preceding Claim further comprising 

positioning means for varying and indicating on the display monitor said second display position at which said 
40 property page selected by said selection means and included in said second property sheet system is display- 

able by said second property sheet system. 

6. The apparatus of any preceding claim further including 

45 docking means for placing said property page selected by said selection means into a selected property sheet 

system for inclusion therein, said property page being displayabie on the display monitor by said selected prop- 
erty sheet system. 

7. The apparatus of Claim 6 further comprising 

50 

positioning means for varying and Indicating the position of the display monitor of a synnbot representative of a 
property page selected by said selection means, and 

proximity means for deternnining a parameter responsive to the distance on the display nrK>nitor between said 
symbol and the position on the display monitor of a displayed property page of a property sheet system, and 
55 wherein said parameter is less than a first selected value, said docking means in response to a first user input 

places said selected property page In said property sheet system displaying said dsplayed property page for 
inclusion therein and for display on the display monitor thereby. 

8. The apparatus of Claim 7 wherein when said parameter is greater than a second selected value, said creation 
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means in response to a second user input displays said selected property pajge included in said second property 
sheet system at a position on the display monitor determined by the display position of said symbol. 

9. The apparatus of Claim 7 further comprising 

5 

icon means for displaying on the display monitor an icon having at least a first display state, said icon displayed 
in said first display state when said parameter is less than said first selected value, said first display state for 
indicating to a user that said docking means, in response to said first user input, will place said selected prop- 
erty page into said property sheet system displaying said displayed property page. 

10 

10. The apparatus of Claim 9 wherein said icon means further comprises means for displaying said icon in a second 
display state when said parameter is greater than a second selected amount, said second display state for indicat- 
ing to a user that said second property sheet system will display said property page selected by said selection 
means at a position on the display monitor determined by the position of said symbol. 

IS 

1 1 . A method for displaying property pages on a computer display monitor comprising the steps of 

creating a first property sheet system including at least one property page displayable at a first position on a 
display monitor. 

20 selecting a property page of said first property sheet system, and 

creating a second property sheet system including said selected property page, said selected property page 
being displayable at a second display position on the display monitor. 

12. A method of displaying on a computer display monitor configuration settings governing a peripheral or intercommu- 
25 nication between a computer and a peripheral, comprising the steps of 

creating a first property sheet system including at least one property page displayable at a first position on a 
display monitor, 

selecting a property page of said first property sheet system, and 
30 creating a second property sheet system including said selected property page, said selected property page 

being displayable at a second display position on the display monitor. 

13. The method of Claim 1 1 or Claim 12 further including the steps of 

35 selecting a property page from one of said first and second property sheet systems, and 

docking said property page selected from one of said first and second property sheet systems into the other of 
said first and second property sheet systems for display thereby. 

14. A method fbr displaying property pages on a display monitor, oonrprising the steps of 

40 

creating first and second property sheet systems, said first property sheet system including a property page 
displaying at first display position on the display nnonitor, 
selecting a property page of said first property sheet system, and 

docking said selected property page into said second property sheet system, said selected property page dis- 
45 playable at a second display position on the display monitor. 
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